Carbon


EnableMenuItemIcon

Header: Menus.h Carbon status: Supported

Enables the icon associated with a menu item.

void EnableMenuItemIcon (
    MenuHandle theMenu, 
    UInt16 item
);
theMenu

A handle to the menu containing the icon to be enabled.

item

The item number of the menu item containing the icon.

DISCUSSION

Your application can use the EnableMenuItemIcon function to enable individual menu item icons that have been previously disabled by a call to the function DisableMenuItemIcon. The menu item that contains the icon is unaffected by calling EnableMenuItemIcon. Note that enabling the icon of a currently disabled menu item has no visual effect; however, once the menu item is enabled, the icon is also enabled.

See also the DisableMenuItemIcon and IsMenuItemIconEnabled functions.

VERSION NOTES

This function is available with Mac OS 8.5 and later.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when MenusLib 8.5 or later is installed. Exported by CarbonLib 1.0 and later and by MenusLib 8.5 and later.


© 2000 Apple Computer, Inc. — (Last Updated 4/14/2000)